@fern-api/generator-cli 0.0.31 → 0.0.33

package/dist/cli.cjs

@@ -34,7 +34,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var require_build = __commonJS({
   "../../node_modules/.pnpm/y18n@5.0.8/node_modules/y18n/build/index.cjs"(exports2, module2) {
     "use strict";
-    var fs2 = require("fs");
+    var fs3 = require("fs");
     var util = require("util");
     var path4 = require("path");
     var shim2;
@@ -198,14 +198,14 @@ var require_build = __commonJS({
     }
     var nodePlatformShim = {
       fs: {
-        readFileSync: fs2.readFileSync,
-        writeFile: fs2.writeFile
+        readFileSync: fs3.readFileSync,
+        writeFile: fs3.writeFile
       },
       format: util.format,
       resolve: path4.resolve,
       exists: (file) => {
         try {
-          return fs2.statSync(file).isFile();
+          return fs3.statSync(file).isFile();
         } catch (err) {
           return false;
         }
@@ -224,7 +224,7 @@ var require_build2 = __commonJS({
     "use strict";
     var util = require("util");
     var path4 = require("path");
-    var fs2 = require("fs");
+    var fs3 = require("fs");
     function camelCase3(str) {
       const isCamelCase = str !== str.toLowerCase() && str !== str.toUpperCase();
       if (!isCamelCase) {
@@ -1173,7 +1173,7 @@ var require_build2 = __commonJS({
         if (typeof require !== "undefined") {
           return require(path5);
         } else if (path5.match(/\.json$/)) {
-          return JSON.parse(fs2.readFileSync(path5, "utf8"));
+          return JSON.parse(fs3.readFileSync(path5, "utf8"));
         } else {
           throw Error("only .json config files are supported in ESM");
         }
@@ -2881,7 +2881,7 @@ var require_get_caller_file = __commonJS({
 var require_require_directory = __commonJS({
   "../../node_modules/.pnpm/require-directory@2.1.1/node_modules/require-directory/index.js"(exports2, module2) {
     "use strict";
-    var fs2 = require("fs");
+    var fs3 = require("fs");
     var join = require("path").join;
     var resolve7 = require("path").resolve;
     var dirname3 = require("path").dirname;
@@ -2918,9 +2918,9 @@ var require_require_directory = __commonJS({
         }
       }
       path4 = !path4 ? dirname3(m.filename) : resolve7(dirname3(m.filename), path4);
-      fs2.readdirSync(path4).forEach(function(filename) {
+      fs3.readdirSync(path4).forEach(function(filename) {
         var joined = join(path4, filename), files, key, obj;
-        if (fs2.statSync(joined).isDirectory() && options.recurse) {
+        if (fs3.statSync(joined).isDirectory() && options.recurse) {
           files = requireDirectory(m, joined, options);
           if (Object.keys(files).length) {
             retval[options.rename(filename, joined, filename)] = files;
@@ -4562,11 +4562,11 @@ ${t5.join("\n")}` : "";
 var require_tmp = __commonJS({
   "../../node_modules/.pnpm/tmp@0.2.3/node_modules/tmp/lib/tmp.js"(exports2, module2) {
     "use strict";
-    var fs2 = require("fs");
+    var fs3 = require("fs");
     var os = require("os");
     var path4 = require("path");
     var crypto = require("crypto");
-    var _c2 = { fs: fs2.constants, os: os.constants };
+    var _c2 = { fs: fs3.constants, os: os.constants };
     var RANDOM_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
     var TEMPLATE_PATTERN = /XXXXXX/;
     var DEFAULT_TRIES = 3;
@@ -4578,13 +4578,13 @@ var require_tmp = __commonJS({
     var FILE_MODE = 384;
     var EXIT = "exit";
     var _removeObjects = [];
-    var FN_RMDIR_SYNC = fs2.rmdirSync.bind(fs2);
+    var FN_RMDIR_SYNC = fs3.rmdirSync.bind(fs3);
     var _gracefulCleanup = false;
     function rimraf(dirPath, callback) {
-      return fs2.rm(dirPath, { recursive: true }, callback);
+      return fs3.rm(dirPath, { recursive: true }, callback);
     }
     function FN_RIMRAF_SYNC(dirPath) {
-      return fs2.rmSync(dirPath, { recursive: true });
+      return fs3.rmSync(dirPath, { recursive: true });
     }
     function tmpName(options, callback) {
       const args = _parseArguments(options, callback), opts = args[0], cb = args[1];
@@ -4597,7 +4597,7 @@ var require_tmp = __commonJS({
       (function _getUniqueName() {
         try {
           const name = _generateTmpName(opts);
-          fs2.stat(name, function(err) {
+          fs3.stat(name, function(err) {
             if (!err) {
               if (tries-- > 0) return _getUniqueName();
               return cb(new Error("Could not get a unique tmp filename, max tries reached " + name));
@@ -4616,7 +4616,7 @@ var require_tmp = __commonJS({
       do {
         const name = _generateTmpName(opts);
         try {
-          fs2.statSync(name);
+          fs3.statSync(name);
         } catch (e) {
           return name;
         }
@@ -4627,10 +4627,10 @@ var require_tmp = __commonJS({
       const args = _parseArguments(options, callback), opts = args[0], cb = args[1];
       tmpName(opts, function _tmpNameCreated(err, name) {
         if (err) return cb(err);
-        fs2.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
+        fs3.open(name, CREATE_FLAGS, opts.mode || FILE_MODE, function _fileCreated(err2, fd) {
           if (err2) return cb(err2);
           if (opts.discardDescriptor) {
-            return fs2.close(fd, function _discardCallback(possibleErr) {
+            return fs3.close(fd, function _discardCallback(possibleErr) {
               return cb(possibleErr, name, void 0, _prepareTmpFileRemoveCallback(name, -1, opts, false));
             });
           } else {
@@ -4644,9 +4644,9 @@ var require_tmp = __commonJS({
       const args = _parseArguments(options), opts = args[0];
       const discardOrDetachDescriptor = opts.discardDescriptor || opts.detachDescriptor;
       const name = tmpNameSync(opts);
-      var fd = fs2.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
+      var fd = fs3.openSync(name, CREATE_FLAGS, opts.mode || FILE_MODE);
       if (opts.discardDescriptor) {
-        fs2.closeSync(fd);
+        fs3.closeSync(fd);
         fd = void 0;
       }
       return {
@@ -4659,7 +4659,7 @@ var require_tmp = __commonJS({
       const args = _parseArguments(options, callback), opts = args[0], cb = args[1];
       tmpName(opts, function _tmpNameCreated(err, name) {
         if (err) return cb(err);
-        fs2.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
+        fs3.mkdir(name, opts.mode || DIR_MODE, function _dirCreated(err2) {
           if (err2) return cb(err2);
           cb(null, name, _prepareTmpDirRemoveCallback(name, opts, false));
         });
@@ -4668,7 +4668,7 @@ var require_tmp = __commonJS({
     function dirSync(options) {
       const args = _parseArguments(options), opts = args[0];
       const name = tmpNameSync(opts);
-      fs2.mkdirSync(name, opts.mode || DIR_MODE);
+      fs3.mkdirSync(name, opts.mode || DIR_MODE);
       return {
         name,
         removeCallback: _prepareTmpDirRemoveCallback(name, opts, true)
@@ -4682,20 +4682,20 @@ var require_tmp = __commonJS({
         next();
       };
       if (0 <= fdPath[0])
-        fs2.close(fdPath[0], function() {
-          fs2.unlink(fdPath[1], _handler);
+        fs3.close(fdPath[0], function() {
+          fs3.unlink(fdPath[1], _handler);
         });
-      else fs2.unlink(fdPath[1], _handler);
+      else fs3.unlink(fdPath[1], _handler);
     }
     function _removeFileSync(fdPath) {
       let rethrownException = null;
       try {
-        if (0 <= fdPath[0]) fs2.closeSync(fdPath[0]);
+        if (0 <= fdPath[0]) fs3.closeSync(fdPath[0]);
       } catch (e) {
         if (!_isEBADF(e) && !_isENOENT(e)) throw e;
       } finally {
         try {
-          fs2.unlinkSync(fdPath[1]);
+          fs3.unlinkSync(fdPath[1]);
         } catch (e) {
           if (!_isENOENT(e)) rethrownException = e;
         }
@@ -4711,7 +4711,7 @@ var require_tmp = __commonJS({
       return sync ? removeCallbackSync : removeCallback;
     }
     function _prepareTmpDirRemoveCallback(name, opts, sync) {
-      const removeFunction = opts.unsafeCleanup ? rimraf : fs2.rmdir.bind(fs2);
+      const removeFunction = opts.unsafeCleanup ? rimraf : fs3.rmdir.bind(fs3);
       const removeFunctionSync = opts.unsafeCleanup ? FN_RIMRAF_SYNC : FN_RMDIR_SYNC;
       const removeCallbackSync = _prepareRemoveCallback(removeFunctionSync, name, sync);
       const removeCallback = _prepareRemoveCallback(removeFunction, name, sync, removeCallbackSync);
@@ -6417,7 +6417,7 @@ var require_dist2 = __commonJS({
 });
 
 // src/cli.ts
-var import_fs5 = __toESM(require("fs"), 1);
+var import_fs6 = __toESM(require("fs"), 1);
 var import_promises6 = require("fs/promises");
 var import_path7 = __toESM(require("path"), 1);
 
@@ -12987,6 +12987,15 @@ var LanguageInfo = {
       }
     };
   },
+  rust: (value) => {
+    return {
+      ...value,
+      type: "rust",
+      _visit: function(visitor) {
+        return LanguageInfo._visit(this, visitor);
+      }
+    };
+  },
   _visit: (value, visitor) => {
     switch (value.type) {
       case "typescript":
@@ -13003,6 +13012,8 @@ var LanguageInfo = {
         return visitor.csharp(value);
       case "php":
         return visitor.php(value);
+      case "rust":
+        return visitor.rust(value);
       default:
         return visitor._other(value);
     }
@@ -13024,6 +13035,7 @@ var Language = {
   Csharp: "CSHARP",
   Typescript: "TYPESCRIPT",
   Php: "PHP",
+  Rust: "RUST",
   _visit: (value, visitor) => {
     switch (value) {
       case Language.Java:
@@ -13040,6 +13052,8 @@ var Language = {
         return visitor.typescript();
       case Language.Php:
         return visitor.php();
+      case Language.Rust:
+        return visitor.rust();
       default:
         return visitor._other();
     }
@@ -13047,17 +13061,18 @@ var Language = {
 };
 
 // src/utils/Writer.ts
+var import_fs5 = __toESM(require("fs"), 1);
 var Writer = class {
-  writeCodeBlock(language, content) {
-    this.writeLine("```" + language);
-    this.write(content);
-    this.writeLine("```");
+  async writeCodeBlock(language, content) {
+    await this.writeLine(`\`\`\`${language}`);
+    await this.write(content);
+    await this.writeLine("```");
   }
-  writeLine(content) {
+  async writeLine(content) {
     if (content === void 0) {
-      this.write("\n");
+      await this.write("\n");
     } else {
-      this.write(`${content}
+      await this.write(`${content}
 `);
     }
   }
@@ -13068,11 +13083,57 @@ var StreamWriter = class extends Writer {
     this.stream = stream;
     this.stream = stream;
   }
-  write(content) {
-    this.stream.write(content);
+  async write(content) {
+    return new Promise((resolve7, reject) => {
+      const handleError = (err) => {
+        this.stream.removeListener("error", handleError);
+        reject(err);
+      };
+      if (this.stream instanceof import_fs5.default.WriteStream) {
+        const canWrite = this.stream.write(
+          content,
+          (error) => {
+            this.stream.removeListener("error", handleError);
+            if (error) {
+              reject(error);
+            } else {
+              resolve7();
+            }
+          }
+        );
+        this.stream.once("error", handleError);
+        if (!canWrite) {
+          this.stream.once("drain", resolve7);
+        }
+      } else {
+        const canWrite = this.stream.write(content);
+        this.stream.once("error", handleError);
+        if (!canWrite) {
+          this.stream.once("drain", () => {
+            this.stream.removeListener("error", handleError);
+            resolve7();
+          });
+        } else {
+          this.stream.removeListener("error", handleError);
+          resolve7();
+        }
+      }
+    });
   }
   end() {
-    this.stream.end();
+    return new Promise((resolve7, reject) => {
+      if (this.stream instanceof import_fs5.default.WriteStream) {
+        this.stream.end(() => {
+          resolve7();
+        });
+        this.stream.once("error", reject);
+        this.stream.once("finish", resolve7);
+      } else {
+        this.stream.write("", () => {
+          resolve7();
+        });
+      }
+    });
   }
 };
 var StringWriter = class extends Writer {
@@ -13081,10 +13142,10 @@ var StringWriter = class extends Writer {
     super();
     this.content = "";
   }
-  write(content) {
+  async write(content) {
     this.content += content;
   }
-  end() {
+  async end() {
     return;
   }
   toString() {
@@ -13100,10 +13161,10 @@ var Block = class {
     this.id = id;
     this.content = content;
   }
-  write(writer) {
-    writer.write(this.content);
+  async write(writer) {
+    await writer.write(this.content);
     if (!this.content.endsWith("\n")) {
-      writer.writeLine();
+      await writer.writeLine();
     }
   }
 };
@@ -13198,42 +13259,41 @@ var ReadmeGenerator = class {
   async generateReadme({
     output
   }) {
-    const blocks = this.generateBlocks();
+    const blocks = await this.generateBlocks();
     const writer = new StreamWriter(output);
-    this.writeHeader({ writer });
-    this.writeBlocks({
+    await this.writeHeader({ writer });
+    await this.writeBlocks({
       writer,
       blocks: await this.mergeBlocks({ blocks })
     });
-    writer.end();
-    return;
+    await writer.end();
   }
-  generateBlocks() {
+  async generateBlocks() {
     const blocks = [];
     if (this.readmeConfig.apiReferenceLink != null) {
       blocks.push(
-        this.generateDocumentation({
+        await this.generateDocumentation({
           docsLink: this.readmeConfig.apiReferenceLink
         })
       );
     }
     if (this.readmeConfig.requirements != null) {
       blocks.push(
-        this.generateRequirements({
+        await this.generateRequirements({
           requirements: this.readmeConfig.requirements
         })
       );
     }
     if (this.readmeConfig.language?.publishInfo != null) {
       blocks.push(
-        this.generateInstallation({
+        await this.generateInstallation({
           language: this.readmeConfig.language
         })
       );
     }
     if (this.readmeConfig.referenceMarkdownPath != null) {
       blocks.push(
-        this.generateReference({
+        await this.generateReference({
           referenceFile: this.readmeConfig.referenceMarkdownPath
         })
       );
@@ -13245,12 +13305,12 @@ var ReadmeGenerator = class {
         continue;
       }
       blocks.push(
-        this.generateFeatureBlock({
+        await this.generateFeatureBlock({
           feature
         })
       );
     }
-    const advancedFeatureBlock = this.generateNestedFeatureBlock({
+    const advancedFeatureBlock = await this.generateNestedFeatureBlock({
       featureId: this.ADVANCED_FEATURE_ID,
       features: advancedFeatures
     });
@@ -13266,7 +13326,7 @@ var ReadmeGenerator = class {
     }
     return feat.advanced ?? false;
   }
-  generateNestedFeatureBlock({
+  async generateNestedFeatureBlock({
     featureId,
     features
   }) {
@@ -13274,13 +13334,13 @@ var ReadmeGenerator = class {
       return void 0;
     }
     const writer = new StringWriter();
-    writer.writeLine(`## ${featureIDToTitle(featureId)}`);
-    writer.writeLine();
+    await writer.writeLine(`## ${featureIDToTitle(featureId)}`);
+    await writer.writeLine();
     for (const feature of features) {
       if (this.shouldSkipFeature({ feature })) {
         continue;
       }
-      this.generateFeatureBlock({
+      await this.generateFeatureBlock({
         feature,
         heading: "###",
         maybeWriter: writer
@@ -13291,27 +13351,27 @@ var ReadmeGenerator = class {
       content: writer.toString()
     });
   }
-  generateFeatureBlock({
+  async generateFeatureBlock({
     feature,
     heading = "##",
     maybeWriter
   }) {
     const writer = maybeWriter ?? new StringWriter();
-    writer.writeLine(`${heading} ${featureIDToTitle(feature.id)}`);
-    writer.writeLine();
+    await writer.writeLine(`${heading} ${featureIDToTitle(feature.id)}`);
+    await writer.writeLine();
     if (feature.description != null) {
-      writer.writeLine(feature.description);
+      await writer.writeLine(feature.description);
     }
-    feature.snippets?.forEach((snippet, index) => {
+    for (const [index, snippet] of feature.snippets?.entries() ?? []) {
       if (index > 0) {
-        writer.writeLine();
+        await writer.writeLine();
       }
-      writer.writeCodeBlock(this.readmeConfig.language.type, snippet);
-    });
+      await writer.writeCodeBlock(this.readmeConfig.language.type, snippet);
+    }
     if (feature.addendum != null) {
-      writer.writeLine(feature.addendum);
+      await writer.writeLine(feature.addendum);
     }
-    writer.writeLine();
+    await writer.writeLine();
     return new Block({
       id: feature.id,
       content: writer.toString()
@@ -13344,154 +13404,162 @@ var ReadmeGenerator = class {
     }
     return void 0;
   }
-  writeBlocks({
+  async writeBlocks({
     writer,
     blocks
   }) {
     for (const block of blocks) {
-      block.write(writer);
+      await block.write(writer);
     }
   }
-  writeHeader({ writer }) {
-    writer.writeLine(
+  async writeHeader({ writer }) {
+    await writer.writeLine(
       `# ${this.organizationPascalCase} ${this.languageTitle} Library`
     );
-    writer.writeLine();
+    await writer.writeLine();
     if (this.readmeConfig.bannerLink != null) {
-      this.writeBanner({
+      await this.writeBanner({
         writer,
         bannerLink: this.readmeConfig.bannerLink
       });
     }
-    this.writeFernShield({ writer });
+    await this.writeFernShield({ writer });
     if (this.readmeConfig.language != null) {
-      this.writeShield({
+      await this.writeShield({
         writer,
         language: this.readmeConfig.language
       });
     }
-    writer.writeLine();
-    this.writeIntroudction({ writer });
+    await writer.writeLine();
+    await this.writeIntro({ writer });
   }
-  writeBanner({
+  async writeBanner({
     writer,
     bannerLink
   }) {
-    writer.writeLine(`![](${bannerLink})`);
-    writer.writeLine();
+    await writer.writeLine(`![](${bannerLink})`);
+    await writer.writeLine();
   }
-  writeFernShield({ writer }) {
+  async writeFernShield({ writer }) {
     const repoSource = this.readmeConfig.remote?.repoUrl ?? `${this.organizationPascalCase}/${this.languageTitle}`;
-    writer.writeLine(
+    await writer.writeLine(
       `[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=${encodeURIComponent(repoSource)})`
     );
   }
-  writeIntroudction({ writer }) {
-    writer.writeLine(
+  async writeIntro({ writer }) {
+    await writer.writeLine(
       this.readmeConfig.introduction != null ? this.readmeConfig.introduction : `The ${this.organizationPascalCase} ${this.languageTitle} library provides convenient access to the ${this.organizationPascalCase} API from ${this.languageTitle}.`
     );
-    writer.writeLine();
+    await writer.writeLine();
   }
-  generateDocumentation({ docsLink }) {
+  async generateDocumentation({
+    docsLink
+  }) {
     const writer = new StringWriter();
-    writer.writeLine("## Documentation");
-    writer.writeLine();
-    writer.writeLine(
+    await writer.writeLine("## Documentation");
+    await writer.writeLine();
+    await writer.writeLine(
       `API reference documentation is available [here](${docsLink}).`
     );
-    writer.writeLine();
+    await writer.writeLine();
     return new Block({
       id: "DOCUMENTATION",
       content: writer.toString()
     });
   }
-  generateReference({
+  async generateReference({
     referenceFile
   }) {
     const writer = new StringWriter();
-    writer.writeLine("## Reference");
-    writer.writeLine();
-    writer.writeLine(
+    await writer.writeLine("## Reference");
+    await writer.writeLine();
+    await writer.writeLine(
       `A full reference for this library is available [here](${this.readmeConfig.remote?.repoUrl != null ? `${this.readmeConfig.remote.repoUrl}/blob/HEAD/${referenceFile}` : referenceFile}).`
     );
-    writer.writeLine();
+    await writer.writeLine();
     return new Block({
       id: "REFERENCE",
       content: writer.toString()
     });
   }
-  generateRequirements({
+  async generateRequirements({
     requirements
   }) {
     const writer = new StringWriter();
-    writer.writeLine("## Requirements");
-    writer.writeLine();
+    await writer.writeLine("## Requirements");
+    await writer.writeLine();
     if (requirements.length === 1) {
-      writer.writeLine(`This SDK requires ${requirements[0]}.`);
+      await writer.writeLine(`This SDK requires ${requirements[0]}.`);
     } else {
-      writer.writeLine("This SDK requires:");
+      await writer.writeLine("This SDK requires:");
       for (const requirement of requirements) {
-        writer.writeLine(`- ${requirement}`);
+        await writer.writeLine(`- ${requirement}`);
       }
     }
-    writer.writeLine();
+    await writer.writeLine();
     return new Block({
       id: "REQUIREMENTS",
       content: writer.toString()
     });
   }
-  generateInstallation({
+  async generateInstallation({
     language
   }) {
     if (language.publishInfo == null) {
       throw new Error("publish information is required for installation block");
     }
     const writer = new StringWriter();
-    writer.writeLine("## Installation");
-    writer.writeLine();
+    await writer.writeLine("## Installation");
+    await writer.writeLine();
     switch (language.type) {
       case "typescript":
-        this.writeInstallationForNPM({
+        await this.writeInstallationForNPM({
           writer,
           npm: language.publishInfo
         });
         break;
       case "python":
-        this.writeInstallationForPyPi({
+        await this.writeInstallationForPyPi({
           writer,
           pypi: language.publishInfo
         });
         break;
       case "java":
-        this.writeInstallationForMaven({
+        await this.writeInstallationForMaven({
           writer,
           maven: language.publishInfo
         });
         break;
       case "go":
-        this.writeInstallationForGo({
+        await this.writeInstallationForGo({
           writer,
           go: language.publishInfo
         });
         break;
       case "ruby":
-        this.writeInstallationForRubyGems({
+        await this.writeInstallationForRubyGems({
           writer,
           rubyGems: language.publishInfo
         });
         break;
       case "csharp":
-        this.writeInstallationForNuget({
+        await this.writeInstallationForNuget({
           writer,
           nuget: language.publishInfo
         });
         break;
       case "php":
-        this.writeInstallationForComposer({
+        await this.writeInstallationForComposer({
           writer,
           composer: language.publishInfo
         });
         break;
+      case "rust":
+        await this.writeInstallationForCargo({
+          writer,
+          cargo: language.publishInfo
+        });
+        break;
       default:
         assertNever(language);
     }
@@ -13500,93 +13568,120 @@ var ReadmeGenerator = class {
       content: writer.toString()
     });
   }
-  writeInstallationForNPM({
+  async writeInstallationForNPM({
     writer,
     npm
   }) {
-    writer.writeLine("```sh");
-    writer.writeLine(`npm i -s ${npm.packageName}`);
-    writer.writeLine("```");
-    writer.writeLine();
+    await writer.writeLine("```sh");
+    await writer.writeLine(`npm i -s ${npm.packageName}`);
+    await writer.writeLine("```");
+    await writer.writeLine();
   }
-  writeInstallationForPyPi({
+  async writeInstallationForPyPi({
     writer,
     pypi
   }) {
-    writer.writeLine("```sh");
-    writer.writeLine(`pip install ${pypi.packageName}`);
-    writer.writeLine("```");
-    writer.writeLine();
+    await writer.writeLine("```sh");
+    await writer.writeLine(`pip install ${pypi.packageName}`);
+    await writer.writeLine("```");
+    await writer.writeLine();
   }
-  writeInstallationForMaven({
+  async writeInstallationForMaven({
     writer,
     maven
   }) {
-    writer.writeLine("### Gradle");
-    writer.writeLine();
-    writer.writeLine("Add the dependency in your `build.gradle` file:");
-    writer.writeLine();
-    writer.writeLine("```groovy");
-    writer.writeLine("dependencies {");
-    writer.writeLine(`  implementation '${maven.group}:${maven.artifact}'`);
-    writer.writeLine("}");
-    writer.writeLine("```");
-    writer.writeLine();
-    writer.writeLine("### Maven");
-    writer.writeLine();
-    writer.writeLine("Add the dependency in your `pom.xml` file:");
-    writer.writeLine();
-    writer.writeLine("```xml");
-    writer.writeLine("<dependency>");
-    writer.writeLine(`  <groupId>${maven.group}</groupId>`);
-    writer.writeLine(`  <artifactId>${maven.artifact}</artifactId>`);
-    writer.writeLine(`  <version>${maven.version}</version>`);
-    writer.writeLine("</dependency>");
-    writer.writeLine("```");
-    writer.writeLine();
-  }
-  writeInstallationForGo({
+    await writer.writeLine("### Gradle");
+    await writer.writeLine();
+    await writer.writeLine("Add the dependency in your `build.gradle` file:");
+    await writer.writeLine();
+    await writer.writeLine("```groovy");
+    await writer.writeLine("dependencies {");
+    await writer.writeLine(
+      `  implementation '${maven.group}:${maven.artifact}'`
+    );
+    await writer.writeLine("}");
+    await writer.writeLine("```");
+    await writer.writeLine();
+    await writer.writeLine("### Maven");
+    await writer.writeLine();
+    await writer.writeLine("Add the dependency in your `pom.xml` file:");
+    await writer.writeLine();
+    await writer.writeLine("```xml");
+    await writer.writeLine("<dependency>");
+    await writer.writeLine(`  <groupId>${maven.group}</groupId>`);
+    await writer.writeLine(`  <artifactId>${maven.artifact}</artifactId>`);
+    await writer.writeLine(`  <version>${maven.version}</version>`);
+    await writer.writeLine("</dependency>");
+    await writer.writeLine("```");
+    await writer.writeLine();
+  }
+  async writeInstallationForGo({
     writer,
     go
   }) {
-    writer.writeLine("```sh");
-    writer.write(`go get github.com/${go.owner}/${go.repo}`);
+    await writer.writeLine("```sh");
+    await writer.write(`go get github.com/${go.owner}/${go.repo}`);
     const majorVersion = getMajorVersion(go.version);
     if (!majorVersion.startsWith("0") && !majorVersion.startsWith("1")) {
-      writer.write(`/v${majorVersion}`);
+      await writer.write(`/v${majorVersion}`);
     }
-    writer.writeLine();
-    writer.writeLine("```");
-    writer.writeLine();
+    await writer.writeLine();
+    await writer.writeLine("```");
+    await writer.writeLine();
   }
-  writeInstallationForRubyGems({
+  async writeInstallationForRubyGems({
     writer,
     rubyGems
   }) {
-    writer.writeLine("```sh");
-    writer.writeLine(`gem install ${rubyGems.packageName}`);
-    writer.writeLine("```");
-    writer.writeLine();
+    await writer.writeLine("```sh");
+    await writer.writeLine(`gem install ${rubyGems.packageName}`);
+    await writer.writeLine("```");
+    await writer.writeLine();
   }
-  writeInstallationForNuget({
+  async writeInstallationForNuget({
     writer,
     nuget
   }) {
-    writer.writeLine("```sh");
-    writer.writeLine(`dotnet add package ${nuget.packageName}`);
-    writer.writeLine("```");
-    writer.writeLine();
+    await writer.writeLine("```sh");
+    await writer.writeLine(`dotnet add package ${nuget.packageName}`);
+    await writer.writeLine("```");
+    await writer.writeLine();
   }
-  writeInstallationForComposer({
+  async writeInstallationForComposer({
     writer,
     composer
   }) {
-    writer.writeLine("```sh");
-    writer.writeLine(`composer require ${composer.packageName}`);
-    writer.writeLine("```");
-    writer.writeLine();
+    await writer.writeLine("```sh");
+    await writer.writeLine(`composer require ${composer.packageName}`);
+    await writer.writeLine("```");
+    await writer.writeLine();
   }
-  writeShield({
+  async writeInstallationForCargo({
+    writer,
+    cargo
+  }) {
+    await writer.writeLine("Add this to your `Cargo.toml`:");
+    await writer.writeLine();
+    await writer.writeLine("```toml");
+    await writer.writeLine("[dependencies]");
+    await writer.writeLine(
+      `${this.getCrateNameFromPackageName(cargo.packageName)} = "${cargo.version}"`
+    );
+    await writer.writeLine("```");
+    await writer.writeLine();
+    await writer.writeLine("Or install via cargo:");
+    await writer.writeLine();
+    await writer.writeLine("```sh");
+    await writer.writeLine(
+      `cargo add ${this.getCrateNameFromPackageName(cargo.packageName)}`
+    );
+    await writer.writeLine("```");
+    await writer.writeLine();
+  }
+  getCrateNameFromPackageName(packageName) {
+    return packageName.includes("/") ? packageName.split("/").pop() ?? packageName : packageName;
+  }
+  async writeShield({
     writer,
     language
   }) {
@@ -13596,7 +13691,7 @@ var ReadmeGenerator = class {
         if (npm == null) {
           return;
         }
-        this.writeShieldForNPM({
+        await this.writeShieldForNPM({
           writer,
           npm
         });
@@ -13607,7 +13702,7 @@ var ReadmeGenerator = class {
         if (pypi == null) {
           return;
         }
-        this.writeShieldForPyPi({
+        await this.writeShieldForPyPi({
           writer,
           pypi
         });
@@ -13618,7 +13713,7 @@ var ReadmeGenerator = class {
         if (maven == null) {
           return;
         }
-        this.writeShieldForMaven({
+        await this.writeShieldForMaven({
           writer,
           maven
         });
@@ -13629,7 +13724,7 @@ var ReadmeGenerator = class {
         if (go == null) {
           return;
         }
-        this.writeShieldForGo({
+        await this.writeShieldForGo({
           writer,
           go
         });
@@ -13640,7 +13735,7 @@ var ReadmeGenerator = class {
         if (rubyGems == null) {
           return;
         }
-        this.writeShieldForRubyGems({
+        await this.writeShieldForRubyGems({
           writer,
           rubyGems
         });
@@ -13651,7 +13746,7 @@ var ReadmeGenerator = class {
         if (nuget == null) {
           return;
         }
-        this.writeShieldForNuget({
+        await this.writeShieldForNuget({
           writer,
           nuget
         });
@@ -13662,78 +13757,113 @@ var ReadmeGenerator = class {
         if (composer == null) {
           return;
         }
-        this.writeShieldForComposer({
+        await this.writeShieldForComposer({
           writer,
           composer
         });
         return;
       }
+      case "rust": {
+        const cargo = language.publishInfo;
+        if (cargo == null) {
+          return;
+        }
+        await this.writeShieldForCargo({
+          writer,
+          cargo
+        });
+        return;
+      }
       default:
         assertNever(language);
     }
   }
-  writeShieldForNPM({
+  async writeShieldForNPM({
     writer,
     npm
   }) {
-    writer.write("[![npm shield]");
-    writer.write(`(https://img.shields.io/npm/v/${npm.packageName})]`);
-    writer.writeLine(`(https://www.npmjs.com/package/${npm.packageName})`);
+    await writer.write("[![npm shield]");
+    await writer.write(`(https://img.shields.io/npm/v/${npm.packageName})]`);
+    await writer.writeLine(
+      `(https://www.npmjs.com/package/${npm.packageName})`
+    );
   }
-  writeShieldForPyPi({
+  async writeShieldForPyPi({
     writer,
     pypi
   }) {
-    writer.write("[![pypi]");
-    writer.write(`(https://img.shields.io/pypi/v/${pypi.packageName})]`);
-    writer.writeLine(`(https://pypi.python.org/pypi/${pypi.packageName})`);
+    await writer.write("[![pypi]");
+    await writer.write(`(https://img.shields.io/pypi/v/${pypi.packageName})]`);
+    await writer.writeLine(
+      `(https://pypi.python.org/pypi/${pypi.packageName})`
+    );
   }
-  writeShieldForMaven({
+  async writeShieldForMaven({
     writer,
     maven
   }) {
-    writer.write("[![Maven Central]");
-    writer.write(
+    await writer.write("[![Maven Central]");
+    await writer.write(
       `(https://img.shields.io/maven-central/v/${maven.group}/${maven.artifact})]`
     );
-    writer.writeLine(
+    await writer.writeLine(
       `(https://central.sonatype.com/artifact/${maven.group}/${maven.artifact})`
     );
   }
-  writeShieldForGo({
+  async writeShieldForGo({
     writer,
     go
   }) {
-    writer.write("[![go shield]");
-    writer.write("(https://img.shields.io/badge/go-docs-blue)]");
-    writer.writeLine(`(https://pkg.go.dev/github.com/${go.owner}/${go.repo})`);
+    await writer.write("[![go shield]");
+    await writer.write("(https://img.shields.io/badge/go-docs-blue)]");
+    await writer.writeLine(
+      `(https://pkg.go.dev/github.com/${go.owner}/${go.repo})`
+    );
   }
-  writeShieldForRubyGems({
+  async writeShieldForRubyGems({
     writer,
     rubyGems
   }) {
-    writer.write("[![gems shield]");
-    writer.write(`(https://img.shields.io/gem/v/${rubyGems.packageName})]`);
-    writer.writeLine(`(https://rubygems.org/gems/${rubyGems.packageName})`);
+    await writer.write("[![gems shield]");
+    await writer.write(
+      `(https://img.shields.io/gem/v/${rubyGems.packageName})]`
+    );
+    await writer.writeLine(
+      `(https://rubygems.org/gems/${rubyGems.packageName})`
+    );
   }
-  writeShieldForNuget({
+  async writeShieldForNuget({
     writer,
     nuget
   }) {
-    writer.write("[![nuget shield]");
-    writer.write(`(https://img.shields.io/nuget/v/${nuget.packageName})]`);
-    writer.writeLine(`(https://nuget.org/packages/${nuget.packageName})`);
+    await writer.write("[![nuget shield]");
+    await writer.write(
+      `(https://img.shields.io/nuget/v/${nuget.packageName})]`
+    );
+    await writer.writeLine(`(https://nuget.org/packages/${nuget.packageName})`);
   }
-  writeShieldForComposer({
+  async writeShieldForComposer({
     writer,
     composer
   }) {
-    writer.write("[![php shield]");
-    writer.write("(https://img.shields.io/badge/php-packagist-pink)]");
-    writer.writeLine(
+    await writer.write("[![php shield]");
+    await writer.write("(https://img.shields.io/badge/php-packagist-pink)]");
+    await writer.writeLine(
       `(https://packagist.org/packages/${composer.packageName})`
     );
   }
+  async writeShieldForCargo({
+    writer,
+    cargo
+  }) {
+    await writer.write("[![crates.io shield]");
+    await writer.write(
+      `(https://img.shields.io/crates/v/${this.getCrateNameFromPackageName(cargo.packageName)})]`
+    );
+    await writer.writeLine(
+      `(https://crates.io/crates/${this.getCrateNameFromPackageName(cargo.packageName)})`
+    );
+  }
   generateContributing() {
     return new Block({
       id: "CONTRIBUTING",
@@ -13776,6 +13906,8 @@ function languageToTitle(language) {
       return "C#";
     case "php":
       return "PHP";
+    case "rust":
+      return "Rust";
     default:
       assertNever(language);
   }
@@ -13790,7 +13922,7 @@ function getMajorVersion(version) {
   return version.split(".")[0] ?? "0";
 }
 function assertNever(x) {
-  throw new Error("unexpected value: " + JSON.stringify(x));
+  throw new Error(`unexpected value: ${JSON.stringify(x)}`);
 }
 
 // src/readme/ReadmeParser.ts
@@ -13816,7 +13948,8 @@ var ReadmeParser = class {
         header += line;
         continue;
       }
-      currentBlock.content += line + "\n";
+      currentBlock.content += `${line}
+`;
     }
     if (currentBlock) {
       blocks.push(currentBlock);
@@ -13846,73 +13979,77 @@ var ReferenceGenerator = class {
   }) {
     this.referenceConfig = referenceConfig;
   }
-  async generate({ output }) {
+  async generate({
+    output
+  }) {
     const writer = new StreamWriter(output);
-    writer.writeLine("# Reference");
+    await writer.writeLine("# Reference");
     if (this.referenceConfig.rootSection != null) {
-      this.writeRootSection({
+      await this.writeRootSection({
         section: this.referenceConfig.rootSection,
         writer
       });
     }
     for (const section of this.referenceConfig.sections) {
-      this.writeSection({ section, writer });
+      await this.writeSection({ section, writer });
     }
-    writer.end();
+    await writer.end();
   }
-  writeRootSection({
+  async writeRootSection({
     section,
     writer
   }) {
     if (section.description != null) {
-      writer.writeLine(section.description);
+      await writer.writeLine(section.description);
     }
     for (const endpoint of section.endpoints) {
-      this.writeEndpoint({ endpoint, writer });
+      await this.writeEndpoint({ endpoint, writer });
     }
   }
-  writeSection({
+  async writeSection({
     section,
     writer
   }) {
-    writer.writeLine(`## ${section.title}`);
+    await writer.writeLine(`## ${section.title}`);
     if (section.description != null) {
-      writer.writeLine(section.description);
+      await writer.writeLine(section.description);
     }
     for (const endpoint of section.endpoints) {
-      this.writeEndpoint({ endpoint, writer });
+      await this.writeEndpoint({ endpoint, writer });
     }
   }
-  writeEndpoint({
+  async writeEndpoint({
     endpoint,
     writer
   }) {
     const stringWriter = new StringWriter();
     if (endpoint.description != null) {
-      stringWriter.writeLine(
+      await stringWriter.writeLine(
         `#### \u{1F4DD} Description
 
-${this.writeIndentedBlock(this.writeIndentedBlock(endpoint.description))}
+${this.generateIndentedBlock(this.generateIndentedBlock(endpoint.description))}
 `
       );
     }
-    stringWriter.writeLine(
+    await stringWriter.writeLine(
       `#### \u{1F50C} Usage
 
-${this.writeIndentedBlock(
-        this.writeIndentedBlock(
-          "```" + this.referenceConfig.language.toLowerCase() + "\n" + endpoint.snippet + "\n```"
+${this.generateIndentedBlock(
+        this.generateIndentedBlock(
+          `\`\`\`${this.referenceConfig.language.toLowerCase()}
+${endpoint.snippet}
+\`\`\``
         )
       )}
 `
     );
     if (endpoint.parameters.length > 0) {
-      stringWriter.writeLine(
+      await stringWriter.writeLine(
         `#### \u2699\uFE0F Parameters
 
-${this.writeIndentedBlock(
+${this.generateIndentedBlock(
           endpoint.parameters.map(
-            (parameter) => this.writeIndentedBlock(this.writeParameter(parameter))
+            (parameter) => this.generateIndentedBlock(this.generateParameter(parameter))
           ).join("\n\n")
         )}
 `
@@ -13922,19 +14059,19 @@ ${this.writeIndentedBlock(
     if (endpoint.title.returnValue != null) {
       linkedSnippet += ` -> ${this.wrapInLink(endpoint.title.returnValue.text, endpoint.title.returnValue.location)}`;
     }
-    writer.writeLine(
+    await writer.writeLine(
       `<details><summary><code>${linkedSnippet}</code></summary>`
     );
-    writer.writeLine(this.writeIndentedBlock(stringWriter.toString()));
-    writer.writeLine("</details>\n");
+    await writer.writeLine(this.generateIndentedBlock(stringWriter.toString()));
+    await writer.writeLine("</details>\n");
   }
-  writeParameter(parameter) {
+  generateParameter(parameter) {
     const desc = parameter.description?.match(/[^\r\n]+/g)?.length;
     const containsLineBreak = desc != null && desc > 1;
     return `**${parameter.name}:** \`${this.wrapInLink(parameter.type, parameter.location)}\` ${parameter.description != null ? (containsLineBreak ? "\n\n" : "\u2014 ") + parameter.description : ""}
     `;
   }
-  writeIndentedBlock(content) {
+  generateIndentedBlock(content) {
     return `<dl>
 <dd>
 
@@ -13956,13 +14093,13 @@ void yargs_default(hideBin(process.argv)).scriptName(process.env.CLI_NAME ?? "ge
   "Generate a README.md using the provided configuration file.",
   (argv) => argv.option("config", {
     string: true,
-    requred: true
+    required: true
   }).option("original-readme", {
     string: true,
-    requred: false
+    required: false
   }).option("output", {
     string: true,
-    requred: false
+    required: false
   }),
   async (argv) => {
     if (argv.config == null) {
@@ -13990,10 +14127,10 @@ void yargs_default(hideBin(process.argv)).scriptName(process.env.CLI_NAME ?? "ge
   "Generate an SDK reference (`reference.md`) using the provided configuration file.",
   (argv) => argv.option("config", {
     string: true,
-    requred: true
+    required: true
   }).option("output", {
     string: true,
-    requred: false
+    required: false
   }),
   async (argv) => {
     if (argv.config == null) {
@@ -14114,7 +14251,7 @@ async function createWriteStreamFromFile(filepath) {
   if (!await doesPathExist(filepath)) {
     await (0, import_promises6.mkdir)(import_path7.default.dirname(filepath), { recursive: true });
   }
-  return import_fs5.default.createWriteStream(filepath);
+  return import_fs6.default.createWriteStream(filepath);
 }
 /*! Bundled license information:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fern-api/generator-cli",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "type": "module",
   "main": "dist/cli.cjs",
   "source": "src/index.ts",